home *** CD-ROM | disk | FTP | other *** search
/ Over 1,000 Windows 95 Programs / Over 1000 Windows 95 Programs (Microforum) (Disc 1).iso / 0935 / matchdir.txt < prev    next >
Text File  |  1996-11-11  |  10KB  |  247 lines
  1. MATCHDIR.TXT File  
  2. =================
  3.  
  4.  
  5. Documentation for MatchDir.exe, Version 1
  6.  
  7. Copyright Jack MacDonald, 1996
  8. ========================================================================
  9. This file has 4 parts:
  10.  
  11. Part        Title
  12. 1        Installing MatchDir
  13. 2        Using MatchDir 
  14. 3        Reporting Bugs
  15. 4        Disclaimer, Registration, and Redistribution
  16. ========================================================================
  17. Part 1: Installing MatchDir
  18.  
  19. The Zip File
  20. You should have received MatchDir as a zip file, and the file you 
  21. are reading is part of that zip file. 
  22.  
  23. The Individual Files
  24. MatchDir consists of three files in total. This file, MatchDir.TXT 
  25. is the documentation and MatchDir.EXE is the program file. Register.txt
  26. contains instructions for registering with the author. Unzip all
  27. the files into any directory of your choice. 
  28.  
  29. Use Win3.x File Manager to drag MatchDir.EXE into one of your 
  30. Program Manager groups, or make a shortcut on your Win95 desktop 
  31. or Start menu.
  32.  
  33. MatchDir is written in Visual Basic 3.0, therefore, it requires 
  34. VBRUN300.DLL to be installed on your computer. In order to save 
  35. space, VBRUN300.DLL has not been included with this distribution 
  36. file, but you likely already have VBRUN300.DLL on your computer. 
  37. If you have any difficulty running MatchDir, then look through 
  38. your computer to locate VBRUN300.DLL. Move the file into your 
  39. \WINDOWS directory (you need just one copy of this file). 
  40.  
  41. If you can't find VBRUN300.DLL on your computer, ask a friend or 
  42. download it from one of the more popular shareware sites on the 
  43. Internet, Compuserve, America Online, or other sites.
  44.  
  45. To uninstall MatchDir, just delete the EXE and INI files.
  46.  
  47. ========================================================================
  48. Part 2. Using MatchDir 
  49.  
  50. Program Overview
  51. MatchDir is used to compare the contents of two directories and 
  52. then to copy, delete, or move files from the source directory. 
  53. You can copy files to a third directory if desired. The source 
  54. directory is always on the left, and the target on the right. 
  55.  
  56. You can press the GoSource button to set the target directory to 
  57. the same location as the source directory. Press Swap to swap the 
  58. source and target directories.
  59.  
  60. Press the Mirror button to go to an identical-named directory on 
  61. the target drive as on the source drive. MatchDir will create the 
  62. directory if it does not exist on the target drive.
  63.  
  64. File Views
  65. MatchDir uses two different views to show the files. The first 
  66. view shows the source and target directories in two lists, while 
  67. the second view shows a single, matched-list view of the files. 
  68. The source and target directories display the files in "dimmed" 
  69. mode, and you cannot select the files from these lists. You can 
  70. do file-management only when the matched-list view is 
  71. displayed because the command buttons are hidden until the 
  72. matched-list view is displayed. 
  73.  
  74. When a file in the source directory has an identically-named mate 
  75. in the target directory, then both files are shown on the same 
  76. line. When a file does not have a matching file in the opposite 
  77. directory, it is shown on its own line. 
  78.  
  79. On slower computers or over a network connection, the matching 
  80. process may take a few seconds -- that's why the two views were 
  81. required. As you navigate through directories, MatchDir will 
  82. display the files in the two-list view without the processing 
  83. delay. When you settle on the source and target directories, 
  84. MatchDir will automatically change to the matched-list view after 
  85. a few seconds. You can also press the Match'Em button to switch 
  86. to the matched-list view.
  87.  
  88. You can press the Cancel File Matching button during the matching 
  89. process. MatchDir will display the list of files to the point 
  90. when you pressed Cancel.
  91.  
  92. MisMatched File Extensions
  93. MatchDir has a special mode where it can match files between 
  94. directories if they have the SAME NAME but DIFFERENT EXTENSIONS. 
  95. To invoke this mode, just type a "*.ext" partial file name into 
  96. the file-mask box (e.g. *.cdr). MatchDir will display a second 
  97. file-mask box. When you enter a "*.ext" mask (e.g. *.wmf) into 
  98. the second box, MatchDir will turn the second box red and disable 
  99. the Copy and Move buttons.
  100.  
  101. When using the MisMatched Extensions mode, MatchDir will match 
  102. (for example) DEMO.CDR in the source directory with DEMO.WMF in 
  103. the target directory. This can be quite handy if you process some 
  104. files through various filters to create new files. You can easily 
  105. check that all the source files have mates in the target directory,
  106. even if the file extensions are different.
  107.  
  108. Managing Files
  109. After creating the matched-list view, MatchDir makes it easy to 
  110. determine if the same-named file exists in both directories, and 
  111. which version is newer. For identically-named files, a symbol is 
  112. shown between the two names to indicate whether the source file 
  113. is newer, older, or the same age as the target file.
  114.  
  115. You can control whether the list includes all the files, files 
  116. with same names, or files with different names. Press the All, 
  117. Same, or Different buttons. For files with identical names, you 
  118. can control whether all, same, or different dates will be 
  119. displayed by using the appropriate radio buttons. Experiment... 
  120. You will figure it out in a hurry.
  121.  
  122. You select files using standard Windows techniques: click single 
  123. files or Ctrl-click multiple files. Shift-click ranges of files. 
  124. The Select button cycles between selecting the newer, equal, or 
  125. older files in the source directory.
  126.  
  127. Press the Copy, Move, or Delete buttons to perform the action. 
  128. File movement is always from the source (left) to the target 
  129. (right).
  130.  
  131. To copy files from the target to another location, press the Copy
  132. To.. button. MatchDir will ask for the location of the target 
  133. directory.
  134.  
  135. Setup and the INI File
  136.  
  137. The default symbols for newer, equal, and older files are +, =, 
  138. and < respectively. I found that + is easier to distinguish for 
  139. newer files than >. Your tastes may vary...  Use the Setup button 
  140. to enter the symbols of your choice.
  141.  
  142. You can also determine the delay that MatchDir uses before 
  143. switching from the two-list to the matched-list view. I find that 
  144. a longer delay is better on slower computers in order to avoid 
  145. the annoying processing delay while MatchDir compares the source 
  146. and target directories, especially when the directories contain 
  147. hundreds of files.
  148.  
  149. MatchDir will write MatchDir.INI when the program exits. It will 
  150. save the location of the source and target directories so you can 
  151. start again in the same location for your next session.
  152.  
  153.  
  154. Command-Line Operation
  155. MatchDir will use an optional command-line parameter to determine 
  156. the initial source directory. You can add a command-line 
  157. parameter to the icon properties under Win 3.x or to the shortcut 
  158. properties under Win 95. For example:
  159.      c:\util\matchdir.exe c:\
  160. will start the program in the root directory of c: You can make 
  161. several icons or shortcuts to start the program in different 
  162. directories.
  163.  
  164. You can also use the command-line parameter under programs like 
  165. Norton File Manager for Win95. For example, I have a custom 
  166. command button on my Norton Toolbar that launches:
  167.      c:\util\matchdir %dir%
  168. This starts MatchDir in the currently-selected directory in File 
  169. Manager. Very handy..
  170.  
  171. Network Installation
  172. MatchDir looks for Matchdir.INI in the same directory as 
  173. MatchDir.EXE, and MatchDir will create the file if it does not 
  174. exist.
  175.  
  176. If you want to share MatchDir on a network and allow each user to 
  177. customize the MatchDir settings, then you should add the 
  178. following lines to MatchDir.INI in the program directory:
  179.      [matchdir]
  180.      IniFile=x:\dir\matchdir.ini
  181.  
  182. where x:\dir is a unique network location for each user, as 
  183. controlled by their login script. You could even enter 
  184. c:\windows\matchdir.ini if you wanted the INI file to be located 
  185. on the individual computer instead of the server. 
  186.  
  187. Give all users read-only privileges to MatchDir.EXE and 
  188. the shared copy of MatchDir.INI.
  189.  
  190. MatchDir will create the INI file for each user as specified in 
  191. the shared MATCHDIR.INI file that is located with MatchDir.EXE.
  192.  
  193. ========================================================================
  194. Part 3: Reporting Bugs
  195.  
  196. If You Find A Bug
  197. In the event that MatchDir doesn't do what you have asked, try 
  198. deleting the files and re-installing from the Zip file. Ensure 
  199. that VBRUN300.DLL is available on your computer in a directory on 
  200. your search path. 
  201.  
  202. If you are still convinced that MatchDir has a bug, please inform 
  203. me by writing to macdonald@infomatch.com with the subject line 
  204. MatchDir Bug.
  205.  
  206. ========================================================================
  207. Part 4: Disclaimer, Registration, and Redistribution
  208.  
  209. Standard Disclaimer
  210. MatchDir is provided AS IS without warranty of any kind, either 
  211. express or implied. In no event shall Jack MacDonald be held 
  212. liable for any damages whatsoever including direct, indirect, 
  213. incidental, consequential, loss of business profits or special 
  214. damages.
  215.  
  216. Registration
  217. MatchDir is distributed as shareware. If you use MatchDir for 
  218. more than a 30-day evaluation period, then you are obliged to 
  219. register it with the author. Registration is $15. 
  220.  
  221. Send your $5 registration fee to:
  222. Jack MacDonald
  223. 5465 Maple Crescent
  224. Delta, BC  Canada   V4K 1G3
  225.  
  226. If you email me for registration, you will receive a registration 
  227. code that removes the "nag" screen. Registration will also encourage 
  228. me to continue to enhance MatchDir.
  229.  
  230. I wrote MatchDir because the programs I was using failed to meet 
  231. my needs in a few instances. I took inspiration from PC Magazine 
  232. / Michael Mefford's DirMatch utility, a DOS program that I have 
  233. used for years. PC Magazine updated DirMatch to a Windows version 
  234. recently, but I found it somewhat limited. I tried some other 
  235. programs with similar features, but I decided to write my own 
  236. program.
  237.  
  238. Redistributing MatchDir
  239. Pass MatchDir to all your friends and colleagues. MatchDir can be 
  240. posted to newsgroups, or put on web pages, provided that the 
  241. entire zip file is included and not just the program. 
  242.  
  243. You can find the latest version of MatchDir on my Web page:
  244.      http://www.infomatch.com/~macdonald
  245.  
  246.  
  247.